home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / M / MUBBS / Dis+10b10 Folder / dis.docs next >
Encoding:
Text File  |  1993-03-27  |  5.8 KB  |  147 lines  |  [TEXT/KAHL]
  1. Discussions+ Documentation - By Scott Szretter
  2.   •••••• BE SURE TO READ THE UPDATE INFO AT THE END OF THIS •••••
  3.  ***** WARNING *****
  4.  
  5.    THIS IS A BETA VERSION!!!!!
  6.  
  7.    THIS VERSION OF DISCUSSIONS + MAY BLOW UP!!!!
  8.  
  9.    THE AUTHOR (Scott Szretter) TAKES NO RESPONSIBILITY FOR THE CONSEQUENCES
  10.     OF THE USE OF THIS MODULE.
  11.  
  12. How to install:  
  13.  
  14.  1) First copy the modle into your modules file like any other module.
  15.    (With res-edit).
  16.             
  17.  2) Copy the 'dis' folder into the same folder as the modules file.
  18.  
  19.  3) Configure!!
  20.  
  21.      How to Configure:
  22.      
  23.      Never edit the  ' .hdr' , ' .txt', '.usr', or '.ext' files!
  24.      Doing so will result in death!
  25.      
  26.      You may edit the dis.bases, dis.intro, dis.help, and dis.menu files.
  27.      
  28.       'dis.intro.lang0' : This is simply a 'welcome to the discussions text' (TEXT).
  29.       'dis.intro.lang1' : This is simply a 'welcome to the discussions text' (ANSI).
  30.       'dis.help.lang0'  : This is a help file - describes menu commands (TEXT).
  31.       'dis.help.lang1'  : This is a help file - describes menu commands (ANSI).
  32.       'dis.menu.lang0'  : The menu the users see (TEXT).
  33.       'dis.menu.lang1'  : The menu the users see (ANSI).
  34.       'dis.bases' : This is how your message areas are set up.
  35.  
  36.          The dis.bases file is set up as follows:
  37.          
  38.          General
  39.          1
  40.          0
  41.          65
  42.          65
  43.          65  
  44.          0   
  45.     150
  46.     0
  47.          
  48.          The first line is the area name.  (70 Max)
  49.          The second line is the security level to access this area.
  50.          The third line is whether or not to use handles in this area.
  51.              0=no, 1=yes (from mubbs user file), 2=yes (user types a handle).
  52.          The fourth line is the length of the to field.  (72 Max)
  53.          The fifth line is the length of the from field.  (72 Max)
  54.          The sixth line is the length of the title field. (72 Max)
  55.          The seventh line is wether to Show the ' Last Message - Add one (Y/N)' 
  56.              if in newscan.  0 = Yes, 1 = No.
  57.      The eighth line is the number of messages allowed in this area.
  58.        Once there are (in this example) 150 messages, the 1st message in that
  59.         area will be deleted as new messages are added.
  60.          ••• NOTE: This does not work yet - it has not been implemented!
  61.      The ninth line is wheter to allow control characters or not.
  62.        Setting this to zero will not allow strange control characters to be
  63.         entered into a message.  This will prevent weird junk.
  64.          Setting this to a 1 will allow any control characters - this is useful
  65.          for areas such as ANSI art, or the like.
  66.          Note: The exact controls it will allow if this is set to zero are...
  67.           ASCII 32 (space) through ASCII 125 (}).
  68.           Of course backspaces and carrige returns are allowed.
  69.                
  70.          Then, this repeats.
  71.          You may have up to 30 message areas.
  72.  
  73.            
  74. There is also an ' .intro.lang1', and '.intro.lang0' file for each area,
  75.    which is sent to the user...
  76.  
  77.  
  78.  
  79. Discussions will create the .ext, .hdr, .txt, and .usr files AUTOMATICALLY!
  80. You should go into each area, and post one message though...
  81.  
  82. The .ext file contains how many messages are in the current area.
  83. The .hdr and .txt files contain the actual message information.
  84. The .usr file contains the info on your users - highest message read, newscan, etc...
  85. Again, dont try to edit these files... it could have very bad effects!
  86.  
  87.  
  88. Please note:
  89.  There IS a "D" command to DELETE messages......
  90.  It works only while "READING" messages - not in Newscan mode...
  91.  BE CAREFUL USING THIS!   IT NEEDS WORK!!!!  YOU MAY SCREW UP THE MESSAGE AREA
  92.   YOU ARE DELETING MESSAGES IN....
  93.  Use it very sparingly.....
  94.  Users can delete messages only if the message is from themselves.
  95.  Users with security over 19 can delete any message.
  96.  
  97. If you wish to put the messages from the old discussions module to the new,
  98.  you will have to do it manually - by reading/copying/pasting.... 
  99.   (From remote)...
  100.   Sorry...
  101.   
  102. If you have any comments, Bugs, Suggestions... or want to DONATE!!!!
  103.  Contact Scott Szretter...
  104.  
  105.  AOL : Scott001
  106.  HMM BBS : (508)655-8927 (14400)
  107.            (508)653-9334 (2400)
  108.  
  109.  
  110.  
  111. Update Info
  112. -----------
  113. B5 - B6  Added fields to the dis.bases file - read docs
  114.          Now using fseeks to increase speed of finding messages....
  115.       •••••• THIS IS EXTREMELY IMPORTANT! ••••••
  116.  
  117.     IF YOU HAVE EVER USED THE DELETE FUNCTION IN A MESSAGE AREA, YOU MUST DELETE THE
  118.    TXT, HDR, EXT and USR files for that area!!!!!!!!!
  119.  
  120.     This is because I have changed the way the messages are read in.
  121.     When A Message is deleted now, it will be shown as DELETED... 
  122.      (I will be writing a program that you will be able to run to clean out deleted 
  123.         messages)
  124.  
  125.     Sorry......
  126. B6 - B7 Sped up the Titles fuction so it uses the new fseek stuff.
  127.  
  128. B7 - B8 Fixed up where dis looks for files...
  129.           So... if you wanted more than one discussions module.... You could 
  130.            simply duplicate the current dis resource in the moudles file, rename it,
  131.            and simply create a new folder with the same name as the new one.
  132.           So the old folder is called "dis" , and the key files are dis.bases,
  133.            dis.help, etc...
  134.           The new one might be folder: dis2, and dis2.help, dis2.bases, etc...
  135.           
  136.       I also added a Reply feature....  (yes, I know what happens when you reply
  137.             many times... (a reply to a reply to a reply... etc...)
  138.           Ill fix it....
  139.  
  140. B8 - B9  Fixed Word Wrap!!!   Hooooray!
  141.            Added ability to Quit while new scanning.... and a few other areas.
  142.            Fix a few small things, and cleaned up a few thingys...
  143.            Oh, and to let everyone know, im working on a small module to
  144.              remove deleted messages from the discussions areas......
  145.               (and it will use that magic number in the dis.bases file ...
  146.                    nummessages)
  147.